home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 July / EnigmA AMIGA RUN 20 (1997)(G.R. Edizioni)(IT)[!][issue 1997-07 & 08][EAR-CD IV].iso / recent2 / amarquee1.44.readme < prev    next >
Text File  |  1997-06-17  |  4KB  |  91 lines
  1. Short:    AmiTCP data broadcast library & server
  2. Author:   jfriesne@ucsd.edu (Jeremy Friesner)
  3. Uploader: jfriesne@ucsd.edu (Jeremy Friesner)
  4. Version:  1.44
  5. Type:     comm/net
  6. Replaces: comm/net/AMarquee1.43.lha
  7. Requires: Workbench 2.04+, AmiTCP3.0b+
  8.  
  9. ----------------------------------------------------------------
  10.         
  11.                          AMARQUEE  v1.44
  12.                      
  13.                         (Released 6/8/97)
  14.                      
  15. ----------------------------------------------------------------
  16.  
  17.  
  18. The Problem: 
  19.  
  20.  You have a great idea for a killer multi-player Internet game 
  21.  or multi-user net app, but it's a total pain in the @)#$* to 
  22.  write all the TCP connection and data synchronization code 
  23.  you'll need to get it going.  So you put your idea on the 
  24.  back-burner and go play "Lemmings" instead.  And thus the 
  25.  Amiga is deprived of a fun Internet app.  D-oh!  :(
  26.  
  27. The Solution:  (well, okay, it's *a* solution, anyway)
  28.  
  29.  AMarquee is a system that handles all of the icky information 
  30.  distribution details for you, allowing you to concentrate on 
  31.  coding your application, rather than on which data goes into 
  32.  which socket when.  AMarquee consists of a shared library and 
  33.  a TCP daemon, which work together to get your data where it 
  34.  needs to be.  Your program simply calls amarquee.library 
  35.  functions to broadcast the data, and waits on a provided 
  36.  MsgPort for data from other hosts.  Easy!
  37.  
  38.  
  39. Features of amarquee.library (the shared library/API):
  40.  
  41.  - Works with AmiTCP, Miami, or any other stack that is "AmiTCP compatible".
  42.  - Simple API that requires no knowledge of socket programming to use.
  43.  - Each AMarquee connection you make automatically and transparently
  44.    starts a seperate execution thread, so your app will never
  45.    be forced to wait while data is sent or received.
  46.  - An arbitrary number of connections may be active at once.
  47.  - Allows you to "subscribe" to data that interests you, so that
  48.    when the data is changed you will be automatically notified.
  49.    You never need to poll for anything!
  50.  - An easy mechanism for sending messages to one or many other
  51.    AMarquee clients that are logged into the same server.
  52.  - Standard Amiga wildcarding is supported in all applicable functions.  
  53.    This allows you to easily and succinctly refer to one host or data 
  54.    item, or many, as appropriate.
  55.  - #includes and several small example applications included.
  56.  - Operation is almost totally asynchronous for efficiency, but
  57.    several easy synchronization methods are available if you need them.
  58.  - Can also be used for direct client-to-client connections and
  59.    for making inetd-launched daemons.
  60.    
  61. Features of AMarqueed (the AmiTCP server):
  62.  
  63.  - Works with AmiTCP, Miami, or any other stack that is "AmiTCP compatible".
  64.  - Fully multithreaded design, with one server process per connection.
  65.  - Re-entrant code, to minimize memory usage.
  66.  - Data is stored in a filesystem-like tree structure for simplicity,
  67.    flexibility and efficiency.  Each client gets its own "home directory"
  68.    that it may write to or read from, and each client may also
  69.    read from the "home directories" of other clients.
  70.  - Efficient design minimizes CPU usage, net bandwidth, and execution time.
  71.  - Limits may be put on memory usage, number of connections, and/or 
  72.    which clients or apps may connect.  Only serve the hosts and apps
  73.    you want to serve!
  74.  - Supports data streaming to one or many clients at once.
  75.  - Data streaming and synchronization features let you be sure your 
  76.    data was read by all interested hosts before you update it again.
  77.  - Automatically detects and eliminates "dead" connections (e.g.
  78.    if the client computer was shut down without quitting politely)
  79.  
  80. WHAT'S NEW IN VERSION 1.44:
  81.  
  82. 1.44 : (Public Release 6/8/97) amarquee.library v44)
  83.  - Added the QNumQueuedPackets and QNumQueuedBytes functions to
  84.    amarquee.library.
  85.  - Added the QErrorName function to amarquee.library
  86.  - Added some additional QERROR_* codes, and added a return value
  87.    to QFreeSession so that it can return them.
  88.  
  89. Note that the server program, AMarqueed, has not changed in this
  90. release.  Only the client side (amarquee.library) has been updated.
  91.